home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dldoor20.zip / DL-DOOR.DOC next >
Text File  |  1993-01-17  |  10KB  |  237 lines
  1.  
  2.  
  3.  
  4.  
  5.                            The File Download Door
  6.                                  Version 2.0
  7.  
  8.                              by: Lance Williams
  9.                                 Kadet PCBoard
  10.                                 P. O. Box 266
  11.                               Camden, NY 13316
  12.                                (315) 245-3815
  13.                                USR DS HST/V.32
  14.  
  15.  
  16.  
  17. Description:
  18.  
  19.         The File  Download  Door is a door you can run on your PCBoard 14.5+
  20.     system to allow users to call into  your  system and be sent to the door
  21.     for a file transfer.  I originally wrote the door for  the  distribution
  22.     of Robert  Falbo's  THEREF  drive  and  controller files.  After that, I
  23.     decided to modify the program to make it more generic and to adapt it to
  24.     make it usable for novice users to download a file easy, such as the new
  25.     PCBoard Caller's Guide.  I have  included  the  setups  for  running the
  26.     program for downloading the Caller's Guide.  I run  it  right  after the
  27.     verification system for new users so they can grab the Caller's Guide if
  28.     they want it on their first call.
  29.  
  30.         This door  will  work with either a pre-assigned ID, or with regular
  31.     callers.  If the user matched the  pre-assigned  ID, he is asked for his
  32.     real name  and city/state he is calling from.  This  is  just  used  for
  33.     logging purposes, so you can track where he is calling from, and who has
  34.     called into  the  door.  If the user is calling on your pre-assigned ID,
  35.     he will be hung up on after a successful file transfer and the used time
  36.     for that caller will be subtracted  from the time used today.  Since the
  37.     preassigned user  is immediately logged off, you need  not  worry  about
  38.     protecting your  system from this ID, as long as you have it set up as a
  39.     log-in door.  Regular system callers  will  have the option of <G>oodbye
  40.     after transfer or returning to PCBoard.
  41.  
  42.  
  43. Setup:
  44.  
  45.     Configuration file:
  46.  
  47.     GUIDE.CNF:
  48.         INTERRUPT
  49.         CALGUIDE.ZIP
  50.         D:\PCB\DL36
  51.         NUL
  52.         GUIDE.LOG
  53.         C:\PCB\MAIN\DOWNLOAD.TXT
  54.         GUIDEOPN
  55.         GUIDEVER
  56.  
  57.  
  58.        ------------------------------------------------------------------
  59.         Support: Kadet PCBoard (315)245-3815 USR DS               Page 1
  60.  
  61.        The Download Door, Version 2.0              Lance Williams, Author
  62.  
  63.  
  64. Line Descriptions:
  65.  
  66.     Line #1:  Either INTERRUPT or BIOS
  67.     Line #2:  File to send caller
  68.     Line #3:  Drive and directory to find file in
  69.     Line #4:  Pre-assigned Caller ID (NUL for no Pre-Assigned ID)
  70.     Line #5:  Door Transfer Log File
  71.     Line #6:  Path/filename of your PCBoard DOWNLOAD.TXT file.
  72.     Line #7:  Filename of the opening screen
  73.     Line #8:  Filename of the version screen (Displays version # and Date)
  74.  
  75.  
  76.         You can  have multiple configuration files for multiple door setups,
  77.     each with it's own caller ID, welcome  &  version screens, log file, and
  78.     file to  send, if you wish.  Just call each by a different  batch  file,
  79.     and assign a different security level to each pre-assigned ID in PCBSM.
  80.  
  81.  
  82.  
  83.  
  84. Transfer Batch files:
  85.  
  86.         The Door   currently   supports  X/Y/Zmodem  transfers  (with  error
  87.     correction if available), using DSZ  from  Omen  Technology.   Please be
  88.     sure to  use  DSZ  and  not  GSZ in the batch files,  as  the  windowing
  89.     routines in  DLDOOR.EXE may be corrupted on the shell to dos to run GSZ.
  90.     I haven't found that to be a problem,  but  better safe than sorry.  The
  91.     batch files  included  should work on your system without  modification.
  92.     the format  of  the  filenames is DLDOORx.BAT, where 'x' is the protocol
  93.     letter (X,O,F,Y,G,Z).  If you find a problem with these batch files, let
  94.     me know....
  95.  
  96.  
  97.  
  98.  
  99. Door Batch File:
  100.  
  101.     GUIDE door batch file:
  102.  
  103.         @echo off
  104.         e:
  105.         cd \doors\dldoor
  106. --->    dl-door guide.cnf c:\pcb    <---
  107.         c:
  108.         cd \pcb
  109.         board
  110.  
  111.     The line that calls the door required  2  parameters,  the configuration
  112.     file, and  the  default  PCB directory for this node  (location  of  the
  113.     PCBOARD.SYS and PCBOARD.DAT files for this caller).
  114.  
  115.  
  116.  
  117.        ------------------------------------------------------------------
  118.         Support: Kadet PCBoard (315)245-3815 USR DS               Page 2
  119.  
  120.        The Download Door, Version 2.0              Lance Williams, Author
  121.  
  122. PCBoard Setups:
  123.  
  124.         To use  this  door as a distribution door under a pre-defined Caller
  125.     ID, you must create an ID for users  to  call  in  under,  the  same  as
  126.     defined in your configuration file.  I created the ID  of THEREF ONLINE,
  127.     and gave  it  a  password of FALBO.  I then let Bob Falbo know of the ID
  128.     and he informed anyone who wished  to call just to get the file, they no
  129.     longer needed to register into the system to DL the file,  and  it saves
  130.     callers 4-7 minutes of online time.
  131.  
  132.         I gave  the  ID  of THEREF ONLINE a security level (5) that no other
  133.     user on the system will ever get,  and  then set up the THEREFDL door as
  134.     follows:
  135.  
  136.     File       Pass  Sec   Login   USER.SYS   DOOR.SYS   SHELL   Batch Path
  137.     ~~~~       ~~~~  ~~~   ~~~~~   ~~~~~~~~   ~~~~~~~~   ~~~~~   ~~~~~~~~~~
  138.     THEREFDL          5      Y        N          N         N
  139.  
  140.         This will make all callers to go directly into  the  door  who  call
  141.     under the  pre-assigned ID when they login.  If a user logs on under the
  142.     pre-assigned ID, the door will recognize  this  fact  (assuming you have
  143.     things configured properly :-> ), and will ask the caller  for  his real
  144.     name for  log purposes.  After a successful download, the caller will be
  145.     logged off by the door, and the USERS file will be properly updated.
  146.  
  147.         Registered users can log into the door as a regular door and use the
  148.     system normally, as well.  They will  be  returned to the system after a
  149.     successful download or logged off, whichever they choose.
  150.  
  151.  
  152.         For the PCBoard Caller's Guide, I set up the system as follows:
  153.  
  154.     File       Pass  Sec   Login   USER.SYS   DOOR.SYS   SHELL   Batch Path
  155.     ~~~~       ~~~~  ~~~   ~~~~~   ~~~~~~~~   ~~~~~~~~   ~~~~~   ~~~~~~~~~~
  156.     GUIDE             8      N        N          N         N
  157.  
  158.         This will  make the door available to all callers  with  a  security
  159.     level of 8 or more (registered/unverified users and above on my system).
  160.     I also used the NUL for the pre-assigned ID so that there are no chances
  161.     of logging off a user after transfer.
  162.  
  163.         By not  making  it  a login door, no one will be sent directly to it
  164.     when they login, but I did add the commands to run the door to the batch
  165.     file I use to run the verification  door  I  wrote.   This way, they are
  166.     verified and then they are asked if they want to DL the Caller's Guide.
  167.  
  168.  
  169.  
  170. Information Logs:
  171.  
  172.         The door  will  update  3 log files:  The node's  Callers  Log,  the
  173.     system's DOWNLOAD.TXT file, and the door's own definable Log file, which
  174.     is similar to the DOWNLOAD.TXT file that PCBoard uses.
  175.  
  176.        ------------------------------------------------------------------
  177.         Support: Kadet PCBoard (315)245-3815 USR DS               Page 3
  178.  
  179.        The Download Door, Version 2.0              Lance Williams, Author
  180.  
  181. Enclosed Setups/Files:
  182.  
  183.         I have included my setups for both THEREF and GUIDE, which are for
  184.     downloading the  Hard  Drive Reference Files (available on Kadet PCBoard
  185.     as THEREFxx.ZIP)  and  for  downloading   the   PCBoard  Caller's  Guide
  186.     (CALGUIDE.EXE), which  Clark  Development Co, Inc. was  kind  enough  to
  187.     allow me  to  include  in  this archive for you in self-extracting form.
  188.     Each of the setups are contained  in  the  internal ZIP's THEREF.ZIP and
  189.     GUIDE.ZIP respectively.  The should prove helpful in setting up the door
  190.     on your system.
  191.  
  192.  
  193.  
  194. Registration:
  195.  
  196.     ****************************  N O T I C E  *****************************
  197.  
  198.     This program is in no way crippled or disabled.  I am  offering  it free
  199.     of charge  as  a  service  to  sysops to make it easier for new users to
  200.     download the new PCBoard Caller's  Guide and THEREF hard drive reference
  201.     files.  However, if you are going to use this door  for  anything  other
  202.     than offering  the PCBoard Caller's Guide (CALGUIDE.EXE/CALGUIDE.ZIP) or
  203.     THEREFxx.ZIP to your users for easy  download,  please consider making a
  204.     donation to support my door programming efforts.  I suggest  a  donation
  205.     of $15.  You may mail your donation to:
  206.  
  207.                                Lance Williams
  208.                                 P. O. Box 266
  209.                               Camden, NY 13316
  210.  
  211.     You will not receive a keyfile or registration number or anything else,
  212.     but just be honoring the shareware agreement.  The donation is in no way
  213.     to be considered a purchase fee for either the PCBoard Caller's Guide OR
  214.     TheRef Hard Drive Reference.
  215.  
  216.     ************************************************************************
  217.  
  218.  
  219.  
  220.  
  221. The Legal Stuff:
  222.  
  223.  
  224.         The Download  Door  ("The  Software")  is  COPYRIGHT  1993 by Lance
  225.     Williams, ALL RIGHTS RESERVED.
  226.  
  227.         The author of this software is not liable for damages suffered as a
  228.     result of  the improper use, proper  use,  or  inability  to  use  this
  229.     software.  This type of disclaimer is prohibited by law in some states,
  230.     and is therefore void in those states.
  231.  
  232.  
  233.  
  234.  
  235.        ------------------------------------------------------------------
  236.         Support: Kadet PCBoard (315)245-3815 USR DS               Page 4
  237.